Qt5.5文档翻译：QWebEnginePage类,QWebEnginePage Class

QWebEnginePage 类，提供了一个对象，用来查看及编辑网页文档。 详细说明……

详细说明

QWebEnginePage 类，提供了一个对象，用来查看及编辑网页文档。

QWebEnginePage 附带 有一个主帧，它负责管理网页内容、导航链接历史及动作。

QWebEnginePage 的应用编程接口狠类似于 QWebEngineView ， 妳仍然可以使用常用的函数，例如： action () ( 就是 QWebEngineView 中的 pageAction ()) 、 triggerAction () 和 findText () 。

可使用 load ()或 setUrl ()来载入一个页面。或者 ，如果 妳已经获取 到了HTML 内容的话，则，也可以使用 setHtml ()。

QWebEnginePage 类还提供了辅助方法，可用来获取当前 由主帧载入的 URL(参考 url ()) ，以及最初请求载入 的 URL(参考 requestedUrl ()) 。利用 这些方法，可以得知在DNS 解析之前和之后的URL，以及载入过程中发生的重定向。如果载入成功 的话，则， requestedUrl () 也会与添加到页面历史( QWebEngineHistory )中去的URL 一致。

HTML 页面 的标题可通过 title ()属性来获取。另外 ，页面可能会指定一个图标，图标可使用icon()属性来获取。如果标题 或图标发生改变，则，会对应地发射 titleChanged ()和iconChanged()信号。 zoomFactor ()属性 可用来改变该页面中显示的内容的整体尺寸。

当页面开始载入时会发射 loadStarted ()信号。 另一方面， 当网页中的某个元素载入完毕时，会发射 loadProgress ()信号，例如 一张嵌入的图片、一个脚本等等。最后 ，当页面内容全部载入完毕时，会发射 loadFinished ()信号，这不包括脚本的执行及页面的渲染。 它的参数，或者为真（true），或者为假（false），表明的是载入操作是否成功。

成员类型文档

enum QWebEnginePage::FindFlag
flags QWebEnginePage::FindFlags

这个枚举，描述的是 findText ()函数所接受的选项。 以下列表中的这些选项，可以通过逻辑或（OR）组合在一起。

FindFlags类型 是 QFlags <FindFlag>的一个类型定义（typedef）。 它储存的是一组FindFlag 值进行逻辑或（OR）运算的结果。

enum QWebEnginePage::WebAction

动作 ，只在处于可用状态的情况下，才能够产生效果。具体 地，动作是否可用，可利用 isEnabled() 来检查，传入由 action ()返回的值作为参数。

属性文档

iconUrl  : const  QUrl

这个属性，储存的是，当前查看的帧的图标的url。

访问函数 ：

参考 iconUrlChanged () 。

title  : const  QString

这个属性，储存的是，当前帧中由HTML <title>元素定义的标题。

访问函数 ：

参考 titleChanged () 。

url  :  QUrl

这个属性，储存的是，当前查看的帧的url。

如果妳设置这个属性的话，会清空该视图，并且载入对应的URL。

默认情况下，这个属性是一个空白、无效的URL。

访问函数 ：

参考 urlChanged () 。

zoomFactor  :  qreal

这个属性，储存的是主帧的缩放因子。

访问函数 ：

成员函数文档

[signal] void  QWebEnginePage:: iconUrlChanged (const  QUrl  &  url )

每当与主帧相关联的图标("favicon")被发现或者发生改变，则发射这个信号。新的URL通过url传递。

参考 iconUrl () 。

[signal] void  QWebEnginePage:: linkHovered (const  QString  &  url )

当鼠标悬停在一个链接上方的时候，会发射这个信号。 url 即为该链接的目标URL。

QWebEngineProfile  * QWebEnginePage:: profile () const

返回 此页面所从属的那个 QWebEngineProfile 。

此函数是从Qt 5.5 开始引入的。

QWebEngineScriptCollection  & QWebEnginePage:: scripts ()

返回此页面所使用的脚本集合。

参考 QWebEngineScriptCollection 。

[signal] void  QWebEnginePage:: titleChanged (const  QString  &  title )

当主帧的标题发生变化时，会发射这个信号。 title字符串即为新的标题。

参考 title () 。